home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 3 / Cream of the Crop 3.iso / clipper / ks94an.zip / PASSWORD.HDR < prev    next >
Text File  |  1994-04-25  |  2KB  |  47 lines
  1. /******************************************************************************
  2.                  The Klipper Library, for CA-Clipper 5.x
  3.         Copyright (c), 1994, Wallace Information Systems Engineering
  4.  
  5. FUNCTION:
  6.  
  7. _Password(nRow,nCol,cPrompt,nStrLen,nMinLen,cColor,lUpper,lShow) --> cString
  8.  
  9. PARAMETERS:
  10.  
  11. nRow      : Row & Col Coordinates at which the password border box
  12. nCol      : is drawn.
  13. cPrompt   : Prompt for Password
  14. nStrLen   : Maximum / cutoff length for password
  15. nMinLen   : Minimum Length of Password
  16. cColor    : Color string to use for password (must be a visible color)
  17. lUpper    : Logical - Forces password to upper case if .T.
  18. lShow     : Logical - echo actual password instead of default "******"
  19.  
  20. SHORT:
  21.  
  22. Provides a coloured, boxed, prompted, hidden or masked password entry field
  23.  
  24. DESCRIPTION:
  25.  
  26. _Password() draws a box whose top-left corner is at nRow, nCol. Inside
  27. this box a prompt is displayed and below that a password is accepted
  28. and returned as the functions return value.
  29.  
  30. NOTE:
  31.  
  32.  
  33.  
  34. EXAMPLE:
  35.  
  36. Pass1 = _Password(5,10,'Enter Password',10,5,'b+/w')
  37.  
  38. A password is accepted that must be at least 5 characters in length but
  39. less than 10 characters.  The password box will be drawn in w+/b.
  40.  
  41. Pass1 = _Password(5,10,'Enter Password',10,5,'b+/w',TRUE,TRUE)
  42.  
  43. Same thing as last example, but this time the password will be forced to
  44. UPPER CASE and will be shown as it is typed.
  45.  
  46. ******************************************************************************/
  47.